home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-20 / eqf40.zip / RIGEQF.EXE / RIG-EQF.DOC < prev    next >
Text File  |  1992-03-07  |  27KB  |  533 lines

  1.  
  2.           PAGE i
  3.          
  4.  
  5.                                RIG-EQF Version 1.50
  6.  
  7.                        Control Program for Kenwood Radios.
  8.  
  9.  
  10.                                Copyright (C) 1992
  11.                             Thomas J. Dandrea N3EQF
  12.  
  13.  
  14.                                   ------------
  15.                                   USER'S GUIDE
  16.                                   ------------
  17.  
  18.  
  19.  
  20.              Rig-EQF is copyrighted by the author, and has been released
  21.              for public distribution as "Shareware" or "User Supported"
  22.              software, for use by radio amateurs and SWL's.  The author
  23.              reserves all rights to this software under copyright laws.          
  24.  
  25.              Registered users of Rig-EQF are provided notification of
  26.              program revisions and technical support if required. The
  27.              registration fee for Rig-EQF is only $10.00.  If you enjoy
  28.              using Rig-EQF, please encourage further program development
  29.              by notifying the author at the address below.
  30.  
  31.  
  32.                              -----------------------
  33.                                Tom Dandrea  N3EQF
  34.                                396 Sautter Drive
  35.                                Coraopolis, PA 15108
  36.                                USA
  37.                              -----------------------
  38.                                  (412) 457-2584
  39.  
  40.                               _______
  41.                          ____|__     |               (R)
  42.                       --|       |    |-------------------
  43.                         |   ____|__  |  Association of
  44.                         |  |       |_|  Shareware
  45.                         |__|   o   |    Professionals
  46.                       -----|   |   |---------------------
  47.                            |___|___|    MEMBER
  48.  
  49.  
  50.              Improvements and revisions to Rig-EQF will be made in direct
  51.              proportion to the number of requests for them.  Your comments
  52.              about the program and suggestions for improvement are welcome.  
  53.  
  54.  
  55.           PAGE ii
  56.  
  57.  
  58.  
  59.  
  60.           ------------------------- CONTENTS -----------------------------
  61.  
  62.  
  63.  
  64.                                                        PAGE NUMBER
  65.                                                        -----------
  66.  
  67.           Definition of Shareware & Disclaimer.............iii
  68.  
  69.           Registration and Support & Ombudsman.............iv          
  70.  
  71.  
  72.  
  73.           1.   Rig-EQF Overview............................1.0
  74.  
  75.           2.   Installation................................2.0
  76.  
  77.           3.   Operation...................................3.0
  78.  
  79.           4.   PROGRAM SCAN CONTROL........................4.0
  80.  
  81.           5.   LOCAL MEMORY CONTROL........................5.0
  82.  
  83.                                                                       PAGE iii
  84.  
  85.      DEFINITION OF SHAREWARE
  86.      -----------------------
  87.      Shareware distribution gives users a chance to try software before buying
  88.      it. If you try a Shareware program and continue using it, you are expected
  89.      to register. Individual programs differ on details -- some request 
  90.      registration while others require it, some specify a maximum trial period.
  91.      With registration, you get anything from the simple right to continue using
  92.      the software to an updated program with printed manual. 
  93.  
  94.      Copyright laws apply to both Shareware and commercial software, and the
  95.      copyright holder retains all rights, with a few specific exceptions as
  96.      stated below. The main difference is in the method of distribution. The
  97.      author specifically grants the right to copy and distribute the software,
  98.      either to all and sundry or to a specific group.
  99.  
  100.      Shareware is a distribution method, not a type of software. You should find
  101.      software that suits your needs and pocketbook, whether it's commercial or
  102.      Shareware. The Shareware system makes fitting your needs easier, because
  103.      you can try before you buy. And because the overhead is low, prices are low
  104.      also. Shareware has the ultimate money-back guarantee -- if you don't use
  105.      the product, you don't pay for it.
  106.  
  107.      DISCLAIMER - AGREEMENT
  108.      ----------------------
  109.      Users of Rig-EQF must accept this disclaimer of warranty: "Rig-EQF is
  110.      supplied as is.  The author disclaims all warranties, expressed or implied,
  111.      including, without limitation, the warranties of merchantability and of
  112.      fitness for any purpose. The author assumes no liability for damages,
  113.      direct or consequential, which may result from the use of Rig-EQF." Rig-EQF
  114.      is a "shareware program" and is provided at no charge to the user for
  115.      evaluation.  Feel free to share it with your friends, but please do not
  116.      give it away altered or as part of another system.  The essence of
  117.      "user-supported" software is to provide personal computer users with
  118.      quality software without high prices, and yet to provide incentive for
  119.      programmers to continue to develop new products.  If you find this program
  120.      useful and find that you are using Rig-EQF and continue to use Rig-EQF
  121.      after a reasonable trial period, you must make a registration payment of
  122.      $10 to N3EQF.  The $10 registration fee will license one copy for use on
  123.      any one computer at any one time.
  124.  
  125.      Anyone distributing Rig-EQF for any kind of remuneration must first contact
  126.      N3EQF at the address above for authorization.  This authorization will be
  127.      automatically granted to distributors recognized by the (ASP) as adhering
  128.      to its guidelines for shareware distributors, and such distributors may
  129.      begin offering Rig-EQF immediately (However N3EQF must still be advised so
  130.      that the distributor can be kept up-to-date with the latest version of Rig-
  131.      EQF).
  132.  
  133.      You are encouraged to pass a copy of Rig-EQF along to your friends for
  134.      evaluation.  Please encourage them to register their copy if they find that
  135.      they can use it.  All registered users will receive a copy of the latest
  136.      version of the Rig-EQF system.                                                                       PAGE iv
  137.  
  138.      REGISTRATION AND SUPPORT POLICY
  139.      -------------------------------
  140.      To become a registered user of Rig-EQF, you must send a $10 fee to the
  141.      author at the address below:
  142.                      
  143.                       ┌───────────────────────────────┐
  144.                       │    Tom Dandrea,  N3EQF        │
  145.                       │    396 Sautter Drive          │
  146.                       │    Coraopolis, PA 15108-9244  │
  147.                       │                               │
  148.                       │    Phone:  (412) 457-2584     │
  149.                       └───────────────────────────────┘
  150.   
  151.      To register, use the form shown on the following page, or provide the 
  152.      information below in any readible format to N3EQF:
  153.  
  154.                          - Current version number of Rig-EQF you're using.
  155.                          - The type of floppy disk you require (i.e., 360K)
  156.                          - Your amateur callsign.
  157.                          - Complete mailing address.
  158.  
  159.      When you become a registered user, you are provided the following:
  160.  
  161.      1.   The current version of Rig-EQF will be sent upon receipt of payment. 
  162.           The program will be supplied on the floppy type you specify.
  163.  
  164.      2.   You will be automatically notified when major revisions to Rig-EQF are
  165.           released.
  166.  
  167.      3.   Technical support is available at the above address and phone number,
  168.           for a minimum period of 6 months after the registration date.  N3EQF
  169.           makes every attempt to correct any problems reported about the use of
  170.           the Rig-EQF program.  I also welcome constructive critism and
  171.           suggestions for improvement.  The current version of Rig-EQF rep-
  172.           resents the collective input received from registered users in the
  173.           last two years.
  174.  
  175.      OMBUDSMAN
  176.      ---------
  177.      Tom Dandrea, N3EQF, is a member of the Association of Shareware
  178.      Professionals (ASP).  ASP wants to make sure that the shareware priciple
  179.      works for you. If you are unable to resolve a shareware-related problem
  180.      with an ASP member by contracting the member directly, ASP may be able to
  181.      help. The ASP Ombudsman can help you resolve a dispute or problem with an
  182.      ASP member, but does not provide technical support for members' products. 
  183.      Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442 or
  184.      send a CompuServe message via CompuServe Mail to ASP Ombudsman 70007,3536.      REGISTRATION FORM                                                PAGE v
  185.  
  186.                          Rig-EQF 1.50 Registration and Order Form 
  187.  
  188.           Your Name:  _______________________________Callsign:_____________
  189.           Address:  _______________________________________________________
  190.           City: _____________________________  State/Province: ____________
  191.           Country: ____________________________  Zip/Postcode: ____________
  192.  
  193.           -----------------------------------------------------------------
  194.  
  195.           Computer Make: _________________________  Model: ________________
  196.         
  197.           Video: __MDA __CGA __EGA __MCGA __VGA __Hercules  Other:_________
  198.           Monitor: __Monochrome __Color __Black-and-White  Other___________
  199.           
  200.           DOS Version: ________     Do you have a hard disk? __Yes __No
  201.           
  202.           Floppy diskette sizes you use:
  203.               5 1/4"  __360Kb  __1.2Mb     3 1/2"  __720Kb  __1.44Mb
  204.               Other (please specify): _____________________________________
  205.           
  206.           Printer Make: _____________________  Model: _____________________
  207.           Do you use expanded or extended memory?  __Yes  __No
  208.  
  209.           Do you use a mouse? _____________________________________________
  210.  
  211.           What model(s) of Kenwood radio do you have interfaced to Rig-EQF?     
  212.  
  213.                          __________________________________________________
  214.  
  215.           -----------------------------------------------------------------
  216.           
  217.           Thank you for taking the time to fill out and send in this
  218.           information.  It will help me to provide you with even better
  219.           software and service in the future.  And thanks for supporting
  220.           the shareware concept.
  221.           
  222.           Rig-EQF Registration ...............................:  $10.00
  223.  
  224.                * For orders outside of the U.S., Canada, and Mexico, please
  225.                add $3.00 shipping and handling.                   
  226.                                                                   
  227.                                                           Total: $_________
  228.  
  229.           Please indicate the disk size you prefer: .... __5 1/4"  __3 1/2"
  230.  
  231.           Payment must be in U.S. funds, drawn on a U.S. bank.  Please send
  232.           the completed form, along with a check or money order to:
  233.           
  234.           Tom Dandrea, N3EQF             Technical Support:  (412) 457-2584
  235.           396 Sautter Drive            
  236.           Coraopolis, PA  15108  U.S.A.
  237.                                                                       PAGE 1.0
  238.                                                   
  239.  
  240.  
  241.           1.  RIG-EQF OVERVIEW
  242.           --------------------
  243.  
  244.           Rig-EQF provides computer control over Kenwood radios that utilize
  245.           the IF-232C (or internal) interface.  Various radio parameters can be
  246.           controlled and monitored via the computer, increasing the power and
  247.           flexibility of your station.
  248.  
  249.           Rig-EQF can even be used to control up to four radios, with fast easy
  250.           switching between the serial communications ports.
  251.  
  252.           Below are a few of the radio functions supported by Rig-EQF:
  253.  
  254.               - Large digital display of current VFO frequency.
  255.  
  256.               - Control over VFO frequency with direct entry.
  257.  
  258.               - Shift current frequency up or down in 1MHz increments.
  259.  
  260.               - Tune current frequency in small variable-rate increments.
  261.  
  262.               - Switch between VFO's, select SPLIT, or set VFO's equal.
  263.  
  264.               - Lock current frequency.
  265.  
  266.               - RIT and XIT control for radios with these features.
  267.  
  268.               - Sophisticated programmable scanning, including lower and upper
  269.                 frequency limits, frequency increment, and scanning rate.
  270.  
  271.               - LOCAL MEMORY control; an advanced memory system providing
  272.                 storage of radio parameters on the computer's disk.
  273.  
  274.               - Transmit/Receive control for transceivers.
  275.  
  276.               - Mouse control over most functions.
  277.                                                                       PAGE 2.0
  278.  
  279.           RIG-EQF INSTALLATION
  280.           -------------------
  281.  
  282.           Rig-EQF may be installed on any IBM-compatible DOS computer, as long
  283.           as the DOS is Version 2.1 or higher.  The only other requirement is
  284.           that at least one communications (serial) port is installed on the
  285.           computer; using ports COM1 through COM4. The COM ports are configured
  286.           as follows:
  287.  
  288.           Port Name           I/O Address         Interrupt Request
  289.  
  290.             COM1                 3F8                   IRQ4
  291.             COM2                 2F8                   IRQ3
  292.             COM3                 3E8                   IRQ2
  293.             COM4                 2E8                   IRQ5
  294.  
  295.           To install Rig-EQF, just copy all files from the distribution disk
  296.           to a directory on your hard drive, or onto another floppy if your
  297.           computer does not have a hard drive.  There is only one file required
  298.           to operate Rig-EQF.  It is named RIG-EQF.EXE.
  299.  
  300.           Once Rig-EQF runs, a file called RIG-EQF.CNF will be created.  This
  301.           file stores parameters like the serial port number and scanning
  302.           limits, for reuse each time the program runs.  Once you use the
  303.           LOCAL MEMORY feature in Rig-EQF, other files will be created to
  304.           store memory information.  Memory files always end in ".MEM".
  305.  
  306.           Connect your Kenwood radio to one of the serial ports on your
  307.           computer (COM1 through COM4), following the recommendations in your
  308.           Kenwood manual. You should use a good quality serial cable, preferably
  309.           sheided, and one that uses (at least) 5 wires.  These 5 wires are
  310.           standard for RS-232C devices (like your Kenwood radio), but
  311.           occasionally 3-wire cables are sold.  A 3-wire "RS-232C" cable will
  312.           not work correctly with this program!  The names of the 5 signals
  313.           (thus 5 wires) required for proper operation are: Ground, Receive
  314.           Data, Transmit Data, Clear To Send, and Request to Send.
  315.  
  316.           With your radio connected to one of the computer's serial ports, turn
  317.           on the radio and the IF-232C level translator (the IF-232C is not
  318.           required for some Kenwood models), and then start Rig-EQF.  Rig-EQF
  319.           will attempt to communicate with the COM1 port.  If the program does
  320.           not receive information from COM1, it will prompt you to choose from
  321.           a pop-up menu the correct COM port to activate. If the communication
  322.           link is established successfully, the Main Screen of Rig-EQF will
  323.           appear.
  324.  
  325.           If you have problems getting Rig-EQF to run initially, try starting
  326.           the program specifying the serial communications port for your radio
  327.           after the program name.  For example, if your radio is connected to
  328.           the COM2 serial port of your computer, type "RIG-EQF 2".
  329.                                                                                 PAGE 3.0
  330.  
  331.  
  332.           3. RIG-EQF OPERATION 
  333.           --------------------
  334.  
  335.           Operation of Rig-EQF is straight-forward; there are no hidden 
  336.           commands. All the available commands are displayed on the program
  337.           screens. The commands themselves consist of a single letter or
  338.           function key, and each command is shown on the screen next to its
  339.           corresponding function.
  340.  
  341.           Note that some commands are not available with certain Kenwood
  342.           models.  In most cases, if the command is not available for the
  343.           radio currently in use, they will not appear on the screen.  For
  344.           example, the transmit/receive, Split, and XIT/RIT controls will
  345.           have no affect with the R5000 receiver.
  346.  
  347.           You may also use your computer's mouse to control the radio 
  348.           commands.  Simply move the mouse cursor to the first letter in the
  349.           command displayed on the screen, and click the left mouse button.
  350.  
  351.           The operation of each command is described below:
  352.  
  353.           <A> Pressing the letter "A" allows you to enter a new frequency
  354.               in VFO A.  A cursor will appear at the upper right of the screen,
  355.               at the position where the existing frequency for VFO A is
  356.               displayed.  You may then enter the desired frequency.  There are
  357.               two ways to enter frequency; either using decimal points in the
  358.               proper places, or by stringing digits together in sequence like
  359.               you would at the radio's front panel.  When you hit <Enter> or
  360.               <Return>, the new frequency will be entered.
  361.  
  362.           <B> The "B" key activates VFO B frequency entry.  This works exactly
  363.               the same way as for VFO A, above.
  364.  
  365.           <=> Hitting the "=" key (equals sign) stores the currently displayed
  366.               (tuned) frequency into both VFO's.
  367.  
  368.           <V> The "V" key causes a switch from the current VFO to the opposite
  369.               VFO. If VFO A is currently selected, VFO B will become the active
  370.               VFO.  The mode settings active when the opposite VFO were in use
  371.               will be recalled with that VFO, the same as if VFO's were switched
  372.               from the radio panel.
  373.  
  374.           <S> Pressing the "S" key will turn the SPLIT function on if it was
  375.               off, or turn in off it was already on.  The word "SPLIT" will
  376.               appear at the upper left of the display, next to the large
  377.               frequency digits, when it is selected.
  378.  
  379.           <D> The "D" key moves the present frequency DOWN 1 MHz.
  380.  
  381.           <U> The "U" key moves the present frequency UP 1 MHz.                                                                                   PAGE 3.1
  382.  
  383.  
  384.           <Page Down> key moves the frequency DOWN in small increments.  The
  385.               smallest increment, available when the key is first depreseed, is
  386.               10 Hz.  If you hold the key down for a few seconds, the rate will
  387.               increase to 100 Hz, and then finally to 1 Khz.  If you release
  388.               the key for a second or two, the rate will return again to the
  389.               slow 10 Hz. rate.  The displayed frequency will continuously be
  390.               updated as you tune.
  391.  
  392.           <Page Up> key moves the frequency UP in the same manner as above.
  393.  
  394.           <Space Bar> is used as the TRANSMIT/RECEIVE switch for transceivers.
  395.               When the radio is transmitting, a flashing TRANSMIT indicator
  396.               will appear at the top of the screen.
  397.  
  398.           <M> The "M" key is used to change the radio MODE.  When you hit the
  399.               key, a box will appear, presenting the available modes to pick
  400.               from.  Use the <Up> and <Down> arrow keys to highlight the proper
  401.               mode, and then hit <Enter>.
  402.  
  403.           <R> Hit the "R" key to turn the RIT function on or off. If the RIT
  404.               is on, the offset will be displayed at the upper right of the
  405.               display.  If the RIT is off, the word "off" will appear in its
  406.               place.  To adjust the RIT offset, use the <Right> and <Left>
  407.               arrow keys to tune up or down, respectively.
  408.  
  409.           <X> The "X" key turns the XIT control on or off. Operation or the XIT
  410.               is the same as for RIT.
  411.  
  412.           <Z> Pressing the letter "Z" will ZERO the XIT and RIT offsets. This
  413.               key zeros the offset reqardless of whether the RIT or XIT is on
  414.               or off.
  415.  
  416.           <I> The "I" key allows you to switch from the currently-selected COM
  417.               port to another COM port (and thus another Kenwood radio).  When
  418.               you select this option, a pop-up menu will appear, presenting you
  419.               with a selection for each of the possible COM ports.  If you
  420.               select a port which is not configured, or no response is received
  421.               from the radio, Rig-EQF will beep and wait for you to make another
  422.               selection.  (You may have to repeat the same selection more than
  423.               once if you first select the wrong port).
  424.  
  425.           <P> The letter "P" is used to select the PROGRAM SCAN CONTROL. A new
  426.               menu will be presented showing SCAN options.  See Section 4 of
  427.               this manual for descriptions of the SCAN controls.
  428.  
  429.           <O> Hitting "O" (not zero, but "O") enables the LOCAL MEMORY CONTROL.
  430.               See Section 5 for a description of this system.
  431.                                                                       PAGE 4.0
  432.  
  433.           PROGRAM SCAN CONTROL
  434.           --------------------                 
  435.  
  436.           The PROGRAM SCAN CONTROL screen is used to control the parameters
  437.           related to the scanning function, and to start and stop the scanning
  438.           process.  The keys and their operation are described below:
  439.  
  440.           <L> The "L" key is used to enter the LOWER, or starting frequency
  441.               for the scan.  The frequency is entered in Mhz.  The frequency
  442.               you enter here is where the scan process will start.
  443.  
  444.           <U> Use the "U" key to enter the UPPER, or stopping frequency for
  445.               the scan.  This is the frequency limit (in Mhz) which causes the
  446.               scan to begin again at the lower frequency.
  447.  
  448.           <I> The "I" key is used to enter the INCREMENT frequency.  This is
  449.               the size of the "step" between each frequency change during the
  450.               scan.  The increment frequency is entered in Khz, and the
  451.               smallest increment available is 10 Hz, or 0.01 Khz.
  452.  
  453.           <P> The letter "P" sets the PAUSE time, in seconds, between scan
  454.               increments.  The smallest pause time possible is 0.25 seconds.
  455.               (NOTE: With some computer and radio combinations, scanning at
  456.               a very fast rate can result in intermitent errors.  If you
  457.               experience this problem, just make the pause time slightly
  458.               longer).
  459.  
  460.           <Space Bar> is used to START and STOP the scan.  If the current VFO
  461.               frequency is between the LOWER and UPPER scan limits, the scan
  462.               will begin at the current frequency.  If the current VFO frequency
  463.               is outside the limits, the scan will begin at the lower limit.
  464.               You can use the <Space Bar> to momentarily pause during the scan,
  465.               and then start it again where it left off.
  466.  
  467.           <Esc> key is used to leave the scan screen, and return to the Main
  468.               Screen functions.
  469.  
  470.                                                                       PAGE 5.0
  471.  
  472.           LOCAL MEMORY CONTROL
  473.           --------------------
  474.  
  475.           The LOCAL MEMORY system allows you to store and recall radio
  476.           information, along with a brief description of each memory entry.
  477.           The following keys are available from this screen:
  478.  
  479.  
  480.           <Up> and <Down> Arrow Keys are used to select the memory line to be
  481.           saved or recalled.  Each "Page" of memories contains 22 lines, and
  482.           each line is one memory.
  483.  
  484.           <F1> This function key is used to store the present radio information
  485.                (Frequency, VFO, Mode, Split), on the currently-highlighted line.
  486.                When you first hit this key, the current status of the radio (as
  487.                indicated by the window at the lower right corner of the screen)
  488.                will be captured and saved.  A cursor will appear in the
  489.                "COMMENT" column of the highlighted line.  You may then enter a
  490.                brief description of this memory for identification.
  491.  
  492.           <F2> Hitting the <F2> function key will recall the memory shown by
  493.                the currently-highlighted line.  This means your radio will
  494.                change to the frequency and mode (as well as split, if that's
  495.                what the condition was when the memory was saved) to reflect
  496.                that memory line.  Hitting the <Return> or <Enter> key will do
  497.                the same thing as this function key.
  498.  
  499.           <F3> This key will display a cursor at the "FREQUENCY" column of the
  500.                currently-highlighted memory line.  You may type in a frequency
  501.                different than the one displayed, or you can hit <Enter> to keep
  502.                the original frequency.  Once you hit <Enter>, the cursor will
  503.                move to the "MODE" column, the next time you hit <Enter> the
  504.                cursor will move to the "VFO" column, and finally to the
  505.                "COMMENT" column.  At each location, you may either type in new
  506.                information or just hit <Enter> to keep the old information.
  507.  
  508.           <F4> The <F4> function key displays the existing memory files for the
  509.                current disk directory.  You can select an existing memory  by
  510.                positioning the highlight bar to the file name, and hitting
  511.                the <Enter> key.  The memories contained in that file will then
  512.                be displayed.  You can create new pages by hitting any other key
  513.                besides the arrow keys.  This will cause a prompt to appear at
  514.                the  bottom of the screen, asking you to enter a memory file
  515.                name.  A new file will be created, using the first 8 characters
  516.                you supply at the prompt.  The last four characters of the file
  517.                are always ".MEM", and the Rig-EQF program will automatically add
  518.                these characters.  Memory files are always located in the current
  519.                disk directory, as indicated at the lower left corner of the
  520.                memory page screen.  You may also select another disk directory
  521.                by hitting the <F1> key, to access other memory files.
  522.                                                                       PAGE 5.1
  523.  
  524.           <Esc> Hitting the <Esc> key returns you to the Main Screen.
  525.  
  526.           <Page Up> and <Page Down> will tune the radio frequency of the
  527.                current VFO up or down, the same as on the Main Screen.
  528.  
  529.  
  530.  
  531.  
  532.      ---------- Copyright (C) 1992 -- Thomas J. Dandrea -- N3EQF --------------
  533.